home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1996 September / JCSM Shareware Collection (JCS Distribution) (September 1996).ISO / grapimag / fantasy.zip / FANTASY.DOC < prev    next >
Text File  |  1989-10-15  |  18KB  |  436 lines
  1.  
  2.  
  3.  
  4.  
  5.                              Fantasy
  6.  
  7.                            Version 5.0
  8.  
  9.              Copyright 1987-1989 by Natural Software
  10.                       19 South 5th. Street
  11.                    St. Charles Illinois 60174
  12.                          (312) 377-7320
  13.                        All Rights Reserved
  14.  
  15.  
  16.  
  17.                          October 16, 1989
  18.  
  19.  
  20.                     _______
  21.                ____|__     |               (tm)
  22.             --|       |    |-------------------
  23.               |   ____|__  |  Association of
  24.               |  |       |_|  Shareware
  25.               |__|   o   |    Professionals
  26.             -----|   |   |---------------------
  27.                  |___|___|    MEMBER
  28.  
  29.  
  30.           This program is produced by a member of the Association of 
  31.           Shareware Professionals (ASP).  ASP wants to make sure that
  32.           the shareware principle works for you. If you are unable to
  33.           resolve a shareware-related problem with an ASP member by 
  34.           contacting the member directly, ASP may be able to help. The
  35.           ASP Ombudsman can help you resolve a dispute or problem with
  36.           an ASP member, but does not provide technical support for 
  37.           members' products. Please write to the ASP Ombudsman at 
  38.           P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve
  39.           message via easyplex to ASP Ombudsman 70007,3536
  40.  
  41.  
  42.  
  43.  
  44.                        Equipment required:
  45.                        -------------------
  46.  
  47.      -    IBM compatible PC, XT, AT with IBM compatible Color
  48.           Graphics Display Adapter and (preferably) a color
  49.           display. Fantasy writes directly to the graphics screen
  50.           buffer for speed. It is therefore not compatible with
  51.           other display adapters such as the Hercules standard.
  52.  
  53.      -    Microsoft compatible mouse, with either MOUSE.SYS or
  54.           MOUSE.COM loaded. (Fantasy will run without the mouse,
  55.           and you can cause movement with the cursor keys -- but
  56.           it just isn't the same.)
  57.  
  58.  
  59.                         What is Fantasy?
  60.                         ----------------
  61.  
  62.      -    Quick summary: fantasy creates flowing graphic images
  63.                          on your display as you move your mouse.
  64.  
  65. If art can be fleeting, transitory and personal -- then Fantasy
  66. is an artist's tool, and you are the artist, and you are the
  67. audience.
  68.  
  69. Fantasy is a tool for personal performance art. Like building
  70. sand castles or blowing bubbles, each performance is different
  71. and highly personal.
  72.  
  73. Fantasy lets you control a variety of pleasing and sometimes
  74. hypnotic images on your graphic display. As you move the mouse
  75. the image constantly moves and responds in never-ending, never-
  76. repeating animated sequences.
  77.  
  78.                        How to use Fantasy:
  79.                        -------------------
  80.  
  81. Simply run FANTASY.EXE. An initial display will show a list of
  82. valid commands and the keys used to evoke them:
  83.  
  84.                |--------------------------------------------|
  85.                | Copyright 1987 by Michael Allen            |
  86.                | Move the mouse for some action             |
  87.                | [right button] = change color              |
  88.                | [left  button] = end effect                |
  89.                | [both buttons] = change effect             |
  90.                | [F1] help           [F2] color             |
  91.                | [F3] cursor off/on  [F4] change cursor     |
  92.                | [F5] record file    [F6] replay file       |
  93.                | [F7] erase off/on     [F8] sound on/off    |
  94.                | [Shift F1] Scroll-1   [Shift F2] Scroll-2  |
  95.                | [Esc] stop effect     [F10] Exit           |
  96.                | -------------- Effects ---------------     |
  97.                | [V] Centered Boxes    [B] Boxes            |
  98.                | [R] Rectangles        [L] Lines            |
  99.                | [H] Move Home         [C] Circles          |
  100.                | [M] Multi-Lines       [F] Free lines       |
  101.                | [A] Automatic mode                         |
  102.                | Enter a number to change box size          |
  103.                |--------------------------------------------|
  104.  
  105.  
  106. The keys and their effects are as follows:
  107.  
  108.      [A] Automatic mode  automatic - random cursor movement
  109.      [B] Boxes           constant sized square boxes
  110.      [C] Circles         circles
  111.      [F] Free lines      line length depends on cursor movement
  112.                          lines seem to follow your movement.
  113.      [V] Vert boxes      rectangles remain centered around orig.
  114.                          cursor position
  115.      [L] Lines           normal lines
  116.      [M] Multi-Lines     lets you start new origin with Enter key
  117.                          (Left Button)
  118.      [R] Rectangles      normal rectangles
  119.  
  120.      [F5]                enter filename to record your
  121.                          performance
  122.      [F6]                enter filename to playback recorded
  123.                          performance
  124.      [F7]                toggle erase (xor) graphics effect
  125.      [F8]                toggle sound - pitch is determined by
  126.                          cursor position
  127.      [Shift F1]          scroll full screen up
  128.      [Shift F2]          scroll top and bottom half of screen
  129.                          toward center
  130.  
  131.  
  132. To start the action press any key on your keyboard. Then move
  133. your mouse (or use the cursor keys) and keep it moving slow and
  134. steady to get the idea. You should see the initial square mouse
  135. cursor shape move in response to the mouse, creating a snaking
  136. trail moving off the top of the display. Now press the [B] key to
  137. start the "Box" special effect. When you stop moving the mouse,
  138. animation stops. The idea is to "conduct" the performance by
  139. constantly moving in small or large sweeping curves. Press the
  140. [Esc] key to end the Box effect.
  141.  
  142. Note that the cursor keys (including Home, End, PgUp, PgDn) give
  143. a regular (smoother) interval for cursor movement. This provides
  144. a different effect than when using the mouse which moves the
  145. cursor pixel by pixel depending on the speed you move the mouse.
  146. The interval the cursor moves for each press of a cursor key is
  147. initially set to 8 pixels. To change the cursor movement
  148. interval, enter a number (from the top row of keys, or
  149. temporarily press [Num Lock] on), then move the cursor again. For
  150. example, press "18" to start the cursor moving 18 pixels at a
  151. time. This also affects the scroll rate (see below).
  152.  
  153. You can re-display the initial help screen by pressing the [F1]
  154. key (without moving the mouse).
  155.  
  156.  
  157.                        Alternative method:
  158.                        -------------------
  159.  
  160. You can also run FANTASY.EXE with an optional command line
  161. argument to specify a command file or list of files. This method
  162. causes Fantasy to automatically run a pre-recorded performance.
  163. For example to automatically run the two command files: DEMO1 and
  164. DEMO2, type:
  165.  
  166.                    FANTASY DEMO1 DEMO2 [ENTER]
  167.  
  168. Or, run one of the automatic performance files enter:
  169.  
  170.                       FANTASY AUTO1 [ENTER]
  171.  
  172. These (AUTO1, AUTO2, etc.) start an automatic performance which
  173. sets up one of the special effects, then starts [A]utomatic mode.
  174. Automatic mode continuously moves the cursor semi-randomly until
  175. a key is pressed.
  176.  
  177.  
  178.                          Scrolling modes
  179.                          ---------------
  180.  
  181. What is actually happening as you move the cursor is: the screen
  182. is scrolled up causing the pattern to be repeatedly redrawn in
  183. new locations. The amount (distance) the screen scrolls for each
  184. cursor movement determines the apparent speed. This amount is
  185. controlled by the cursor increment amount which you can change by
  186. entering any number between cursor movements.
  187.  
  188. Fantasy has two scrolling modes. Initially the full screen moves
  189. upward. This is scroll mode 1. Scroll mode 2 causes the screen to
  190. scroll toward the center - the top half scrolls down, the bottom
  191. half scrolls up. You start scroll mode 2 by pressing [Shift F2].
  192. If in mode 2, you can return to scroll mode 1 by pressing [Shift
  193. F1].
  194.  
  195.                          Special effects
  196.                          ---------------
  197.  
  198. You turn on one of the special effects by pressing the key letter
  199. for that effect. For example press [B] to start the Box effect.
  200. To end an effect, press the [Esc] key.
  201.  
  202. The Box effect: press [B] to start the box effect. This causes a
  203. square box to be drawn as the mouse is moved. The size of the box
  204. is determined by the cursor increment value - initially, eight
  205. pixels. You can change this size by: 
  206.  
  207.           1.   press [Esc] to end the current effect.
  208.           2.   enter the new size using the number keys. For
  209.                example enter [48] to change the box size to 48
  210.                pixels.
  211.           3.   return to the box effect by pressing [B].
  212.           4.   Then return to a lower scroll increment value by
  213.                pressing the number keys: [4] for instance.
  214.  
  215.  
  216. The Rectangle effect: press [R] to start the rectangle effect.
  217. This draws rectangles of varying size originating from the
  218. position of the mouse cursor when the effect was started, moving
  219. to the new mouse position as you move.
  220.  
  221. The Vertical Box effect: press [V] to start the this effect. This
  222. draws rectangles whose center remains at the starting cursor
  223. position. Usually the best starting point is the center of the
  224. screen. Press [H] to home the cursor to the center. This effect
  225. is particularly pleasing when scroll mode 2 is active.
  226.  
  227. The Circle effect: press [C] to start the circle effect. This
  228. draws circles of varying size with their center at the position
  229. of the mouse cursor when the effect was started. Their diameter
  230. is changed as you move the mouse.
  231.  
  232. The Line effect: press [L] to start the line effect. This draws a
  233. sequence of lines starting from the position of the mouse cursor
  234. when the effect was started, moving to the new mouse position as
  235. you move.
  236.  
  237. The Multi-Line effect: press [M] to start the Multi_line effect.
  238. This is similar to the line effect, except that you can change
  239. the origin point by pressing the mouse left button. Each time you
  240. press the left button line drawing starts from that new position.
  241.  
  242. The Free lines: press [F] to start the Free lines effect. This
  243. draws a short line (depending on how fast you move the mouse)
  244. that seems to follow the mouse movement like a tail. This effect
  245. is most effective with the mouse cursor off.
  246.  
  247.  
  248.                         Switching Effects
  249.                         -----------------
  250.  
  251. To end one effect and start a new one, press the [Esc] key, then
  252. press the selection key for the new effect.
  253.  
  254. Another way to switch: press both mouse buttons to switch from
  255. one effect to another in sequence without needing to exit. This
  256. allows a more seamless transition from one effect to the next in
  257. your performance. This method will not get you into the Multi-
  258. Line effect, but if you start with the Multi-Line effect then
  259. press both mouse buttons you will eventually return to it.  
  260.  
  261.  
  262.                         The mouse cursor
  263.                         ----------------
  264.  
  265. Turning off the mouse cursor: Some effects appear better with the
  266. mouse cursor turned off. To turn it off:
  267.  
  268.           1.   press [Esc] to end the current effect.
  269.           2.   press [F3] to turn the mouse cursor off.
  270.  
  271. You can turn the mouse cursor back on by repeating the above
  272. steps.
  273.  
  274. Changing the mouse cursor: there are currently three cursor
  275. shapes: The initial square box cursor, a cross cursor and a
  276. diagonal cross with arrows. You change to a new shape by:
  277.  
  278.           1.   press [Esc] to end the current effect.
  279.           2.   press [F4] to turn the change to a new mouse
  280.                cursor shape.
  281.  
  282.  
  283.                            Erase mode
  284.                            ----------
  285.  
  286. Press the [F7] key to turn erase mode "ON" (it is initially
  287. "OFF"). With erase "ON" intersecting patterns cancel each other
  288. (erase). When erase is "OFF", intersecting patterns overwrite.
  289.  
  290.  
  291.  
  292.  
  293.                               Sound
  294.                               -----
  295.  
  296. This is experimental at this point. Press [F8] to toggle sound
  297. "ON" or "OFF". With sound "ON", the pitch changes relative to the
  298. cursor position. This is not that pleasing as currently
  299. implemented. (I'm working on other methods using fractal math to
  300. create more pleasing tone changes.)
  301.  
  302.  
  303.                           Screen Color
  304.                           ------------
  305.  
  306. Fantasy uses the Color Graphics Adapter's high resolution mode of
  307. 640 by 200 pixels. In this mode the background is always black,
  308. but you can change the foreground color to one of the 16 possible
  309. by either:
  310.  
  311.           1.   press the [F2] key, or
  312.           2.   press the mouse right button.
  313.  
  314. This works even while a special effect is on.
  315.  
  316.  
  317.                        Recording to a File
  318.                        -------------------
  319.  
  320. To save (record) your fantasy performance for later playback,
  321. press the [F5] key. You will be asked to enter a filename. Enter
  322. any valid filename with optional drive and path designation. (It
  323. will overwrite any existing files with the same name in the same
  324. path, so be careful.) From that point on, each keystroke and
  325. mouse movement will be saved in that file. To stop recording,
  326. type: [%] (shifted 5). This is the special character to terminate
  327. recording (it is placed in the file to terminate the playback
  328. also).
  329.  
  330.  
  331.                     Playing back from a File
  332.                     ------------------------
  333.  
  334. To begin playing back a performance from a file recorded as
  335. described above, press the [F6] key and enter the filename (drive
  336. and path optional) of a valid performance file. The keystrokes
  337. and mouse movements stored in the file will begin being executed
  338. just as they were recorded. The only difference is that the
  339. timing between events is regular and static. This allows you to
  340. compose your performance files slowly and carefully -- they will
  341. be played back fast and snappy.
  342.  
  343.  
  344.  
  345.  
  346.  
  347.                          Ending Fantasy
  348.                          --------------
  349.  
  350.           1.   press [Esc] to end the current effect.
  351.           2.   press [F10] to exit and return to DOS.
  352.  
  353.  
  354.                        New for version 3.0
  355.                        -------------------
  356.  
  357. This version has improved the playback from a file by loading the
  358. full file into memory before beginning the performance.
  359. Previously, there was a pause each time the disk was accessed
  360. while reading in the file during playback. This was annoying when
  361. reading from a slow floppy. Since the full file is read at one
  362. time, there now is a size limit. That limit is 32,000 bytes.
  363.  
  364. Also new is a separate run-time version of the program.
  365. RUN_FANT.EXE will play a performance file as specified on the
  366. command line. No help messages will be displayed and no
  367. interaction is expected. When the performance file is ended, it
  368. exits to DOS. This version is perfect for being called by DOS
  369. batch files or from other programs.
  370.  
  371.  
  372.                        New for version 4.0
  373.                        -------------------
  374.  
  375. Automatic mode has been added with version 4.0 of Fantasy. This
  376. allows you to sit back and enjoy the different special effects
  377. without moving the cursor yourself. When in automatic mode, the
  378. cursor moves sort of randomly (in a semi-intelligent sort of
  379. way). You start automatic mode by pressing the [A] key. When you
  380. press any other key, automatic mode is terminated.
  381.  
  382. Before starting automatic mode, you should first set up a
  383. specific special effect. For example the following key stroke
  384. sequence (assuming Fantasy's initial states), turns the cursor
  385. off, moves to screen center, starts scroll mode 2, turns on erase
  386. mode, starts the vertical box special effect, then starts
  387. automatic mode:
  388.  
  389.                    [F3][h][Shift F2][F7][v][a]
  390.  
  391. By the way, this example is contained in the "AUTO1" playback
  392. file.
  393.  
  394.  
  395.                        Genesis of Fantasy
  396.                        ------------------
  397.  
  398. You may find it interesting: The fantasy program is the result of
  399. a simple error made while debugging a new graphics program. This
  400. new program called PC-Draft-CAD is an object oriented CAD
  401. drafting program which is similar to our PC-Draft II product
  402. which is a pixel based drafting program. In the course of
  403. debugging, a trace message inadvertently caused the graphics
  404. display to scroll each time the cursor was moved. This caused
  405. effects similar to what you see with Fantasy. We found ourselves
  406. delighted with some of the effects, playing with them for hours.
  407. We have no idea whether this will have the same impact on others,
  408. or whether this phenomenon is strictly personal -- perhaps
  409. because it is our own programming effort. 
  410.  
  411.  
  412.                         Status of Fantasy
  413.                         -----------------
  414.  
  415. The Fantasy program is protected by copyright. It is not to be
  416. resold or used for any commercial purpose or included with any
  417. other product or software collection without our permission. It
  418. is being distributed as shareware. This means that you are
  419. granted the right to freely use Fantasy and to make copies for
  420. your friends.
  421.  
  422. If you want register your copy of Fantasy or to use Fantasy in a
  423. commercial environment (not for your non-business personal use)
  424. you can obtain a license:
  425.  
  426.                Send: $20.00 to:    
  427.  
  428.                     Natural Software
  429.                     19 South 5th. Street
  430.                     St. Charles, Illinois 60174
  431.  
  432. If you would like information on our other products, or would
  433. like to order with your VISA or Master Card, call:
  434.  
  435.                          (312) 377-7320
  436.